home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / trn2401.lzh / install.lzh / MODULES / FCSHELL.DOC next >
Encoding:
Text File  |  1992-02-04  |  3.2 KB  |  97 lines
  1.  
  2.  
  3.                             FC_SHELL v1.2
  4.                             -------------
  5.  
  6.                             by Andy Inman
  7.  
  8.  
  9.  
  10. FC_SHELL is both a replacement for my earlier *IO* and RUNDOOR utilities,
  11. and and add-on to F-Custom, to facilitate running external programs.  The
  12. memory overhead used by FC_SHELL is a mere 2.5 kbytes.
  13.  
  14. If you are already familiar with *IO* and RUNDOOR, then read on.  If not,
  15. please read the enclosed IO.DOC.
  16.  
  17.  
  18.  
  19. Using FC_SHELL to replace *IO* and RUNDOOR
  20. ------------------------------------------
  21.  
  22. FC_SHELL is 'self-contained', ie, it does *not* need to be loaded before
  23. FoReM in the same way that *IO* did.  In effect, you use it instead of RUNDOOR,
  24. but without the need to load *IO* first.
  25.  
  26. The options for FC_SHELL give the same capabilites as RUNDOOR, but are
  27. different in format.
  28.  
  29. The format for calling the program (to be used in your FDOORS.DAT file) is:-
  30.  
  31.            FCSHELL [/options] [path\]<program> [cmd_line]
  32.  
  33. e.g.       FCSHELL /icp c:\utils\gulam.prg startup.g
  34.  
  35.  
  36. Option 'switches'
  37.  
  38.  c      Enables 'carrier detect'.  If the called program is waiting for
  39.         user input, and the carrier drops, the called program will be exited.
  40.         
  41.  i      Enables IO re-direction.  Text output from the called program will
  42.         be sent to both the local screen *and* the modem.  Input will be
  43.         taken from both the local keyboard *and* the modem.
  44.  
  45.  p      The path, if given, (c:\utils\ in the above example) will become
  46.         the 'default' path before the program is executed.  Note, this
  47.         is not *quite* the same as RUNDOOR2, which allowed the program path
  48.         and 'default' path to be specified independantly.
  49.  
  50.  
  51.  
  52. Use with F-Custom
  53. -----------------
  54.  
  55. In addition to the above options, you will also normally use either the
  56. 's' or 'b' options, to prevent FoReM's 'status window' information from
  57. being lost from the screen:-
  58.  
  59.  b      The current screen is saved to a 32k buffer (using 32k of memory)
  60.         before the called program is executed, and restored on extit.  Thus,
  61.         the FoReM screen should be completely unchanged after execution.
  62.  
  63.  s      Enables 'scroll control'.  When the called program outputs a
  64.         line-feed, only the portion of the screen *below* the FoReM status
  65.         window is scrolled (similar to the way F-Custom itself normally
  66.         outputs text).  This is the best option to use, so long as the
  67.         called program does not clear the screen, or send other VT-52
  68.         screen-control sequences.
  69.  
  70. Example:-
  71.  
  72.         {#FCSHELL.PRG /icb pcommand.prg}      (PCommand clears the screen)
  73.  
  74.  
  75. NOTE:-
  76.  
  77. For some reason, which I don't understand, LHARC.TTP will *crash* if the /s
  78. option is used, but seems to work fine with the /b option.  ARC.TTP, on
  79. the other hand, works fine with the /s option.  If anyone can tell me why
  80. this is, please do!!
  81.  
  82.  
  83.  
  84. And finally...
  85. --------------
  86.  
  87. FC_SHELL is free!!  Many people have found my original *IO* and RUNDOOR
  88. programs invaluable, and whilst FC_SHELL doesn't offer any additional
  89. functionality, I hope you will find it a bit easier to use.
  90.  
  91. F-Custom itself is *not* free, but highly recommended <grin>.
  92.  
  93.  
  94. Andy Inman,  Scary MonSTer BBS,  Fnet #1003,  (UK)734 320297.
  95.  
  96. 28th March 1990.
  97.